v5

Compare Source

v2.17.0

Compare Source

Features

• Add isin local execution impl (#​1993) (26df6e6)
• Add reset_index names, col_level, col_fill, allow_duplicates args (#​2017) (c02a1b6)
• Support callable for series mask method (#​2014) (5ac32eb)

v2.16.0

Compare Source

Features

• Add bigframes.pandas.options.display.precision option (#​1979) (15e6175)
• Add level, inplace params to reset_index (#​1988) (3446950)
• Add ML code samples from dbt blog post (#​1978) (ebaa244)
• Add where, coalesce, fillna, casewhen, invert local impl (#​1976) (f7f686c)
• Adjust anywidget CSS to prevent overflow (#​1981) (204f083)
• Format page number in table widget (#​1992) (e83836e)
• Or, And, Xor can execute locally (#​1994) (59c52a5)
• Support callable bigframes function for dataframe where (#​1990) (44c1ec4)
• Support callable for series where method (#​2005) (768b82a)
• When using repr_mode = "anywidget", numeric values align right (15e6175)

Bug Fixes

• Address the packages issue for bigframes function (#​1991) (68f1d22)
• Correct pypdf dependency specifier for remote PDF functions (#​1980) (0bd5e1b)
• Enable default retries in calls to BQ Storage Read API (#​1985) (f25d7bd)
• Fix the copyright year in dbt sample files (#​1996) (fad5722)

Performance Improvements

• Faster session startup by defering anon dataset fetch (#​1982) (2720c4c)

Documentation

• Add examples of running bigframes in kaggle (#​2002) (7d89d76)
• Remove preview warning from partial ordering mode sample notebook (#​1986) (132e0ed)

v2.15.0

Compare Source

Features

• Add st_buffer, st_centroid, and st_convexhull and their corresponding GeoSeries methods (#​1963) (c4c7fa5)
• Add first, last support to GroupBy (#​1969) (41dda88)
• Add value_counts to GroupBy classes (#​1974) (82175a4)
• Allow callable as a conditional or replacement input in DataFrame.where (#​1971) (a8d57d2)
• Can cast locally in hybrid engine (#​1944) (d9bc4a5)
• Df.join lsuffix and rsuffix support (#​1857) (26515c3)

Bug Fixes

• Add warnings for duplicated or conflicting type hints in bigfram… (#​1956) (d38e42c)
• Make remote_function more robust when there are create_function retries (#​1973) (cd954ac)
• Make ExecutionMetrics stats tracking more robust to missing stats (#​1977) (feb3ff4)

Performance Improvements

• Remove an unnecessary extra dry_run query from read_gbq_table (#​1972) (d17b711)

Documentation

• Divide BQ DataFrames quickstart code cell (#​1975) (fedb8f2)

v2.14.0

Compare Source

Features

• Dynamic table width for better display across devices (#​1948) (a6d30ae) (a6d30ae)
• Retry AI/ML jobs that fail more often (#​1965) (25bde9f)
• Support series input in managed function (#​1920) (62a189f)

Bug Fixes

• Enhance type error messages for bigframes functions (#​1958) (770918e)

Performance Improvements

• Use promote_offsets for consistent row number generation for index.get_loc (#​1957) (c67a25a)

Documentation

• Add code snippet for storing dataframes to a CSV file (#​1943) (a511e09)
• Add code snippet for storing dataframes to a CSV file (#​1953) (a298a02)

v2.13.0

Compare Source

Features

• _read_gbq_colab creates hybrid session (#​1901) (31b17b0)
• Add CSS styling for TableWidget pagination interface (#​1934) (5b232d7)
• Add row numbering local pushdown in hybrid execution (#​1932) (92a2377)
• Implement Index.get_loc (#​1921) (bbbcaf3)

Bug Fixes

• Add license header and correct issues in dbt sample (#​1931) (ab01b0a)

Dependencies

• Replace google-cloud-iam with grpc-google-iam-v1 (#​1864) (e5ff8f7)

v2.12.0

Compare Source

Features

• Add code samples for dbt bigframes integration (#​1898) (7e03252)
• Add isin local execution to hybrid engine (#​1915) (c0cefd3)
• Add ml.metrics.mean_absolute_error method (#​1910) (15b8449)
• Allow local arithmetic execution in hybrid engine (#​1906) (ebdcd02)
• Provide day_of_year and day_of_week for dt accessor (#​1911) (40e7638)
• Support params max_batching_rows, container_cpu, and container_memory for udf (#​1897) (8baa912)
• Support typed pyarrow.Scalar in assignment (#​1930) (cd28e12)

Bug Fixes

• Correct min field from max() to min() in remote function tests (#​1917) (d5c54fc)
• Resolve location reset issue in bigquery options (#​1914) (c15cb8a)
• Series.str.isdigit in unicode superscripts and fractions (#​1924) (8d46c36)

Documentation

• Add code snippets for session and IO public docs (#​1919) (6e01cbe)
• Add snippets for performance optimization doc (#​1923) (4da309e)

v2.11.0

Compare Source

Features

• Add __contains__ to Index, Series, DataFrame (#​1899) (07222bf)
• Add thresh param for Dataframe.dropna (#​1885) (1395a50)
• Add concat pushdown for hybrid engine (#​1891) (813624d)
• Add pagination buttons (prev/next) to anywidget mode for DataFrames (#​1841) (8eca767)
• Add total_rows property to pandas batches iterator (#​1888) (e3f5e65)
• Hybrid engine local join support (#​1900) (1aa7950)
• Support date data type for to_datetime() (#​1902) (24050cb)
• Support bpd.Series(json_data, dtype="json") (#​1882) (05cb7d0)

Bug Fixes

• Bpd.merge on common columns (#​1905) (a1fa112)
• DataFrame string addition respects order (#​1894) (52c8233)
• Show slot_millis_sum warning only when allow_large_results=False (#​1892) (25efabc)
• Used query row count metadata instead of table metadata (#​1893) (e1ebc53)

v2.10.0

Compare Source

Features

• df.to_pandas_batches() returns one empty DataFrame if df is empty (#​1878) (e43d15d)
• Add filter pushdown to hybrid engine (#​1871) (6454aff)
• Add simple stats support to hybrid local pushdown (#​1873) (8715105)

Bug Fixes

• Fix issues where duration type returned as int (#​1875) (f30f750)

Documentation

• Update gsutil commands to gcloud commands (#​1876) (c289f70)

v2.9.0

Compare Source

Features

• Add bpd.read_arrow to convert an Arrow object into a bigframes DataFrame (#​1855) (633bf98)
• Add experimental polars execution (#​1747) (daf0c3b)
• Add size op support in local engine (#​1865) (942e66c)
• Create deploy_remote_function and deploy_udf functions to immediately deploy functions to BigQuery (#​1832) (c706759)
• Support index item assign in Series (#​1868) (c5d251a)
• Support item assignment in series (#​1859) (25684ff)
• Support local execution of comparison ops (#​1849) (1c45ccb)

Bug Fixes

• Fix bug selecting column repeatedly (#​1858) (cc339e9)
• Fix bug with DataFrame.agg for string values (#​1870) (81e4d64)
• Generate GoogleSQL instead of legacy SQL data types for dry_run=True from bpd._read_gbq_colab with local pandas DataFrame (#​1867) (fab3c38)
• Revert dict back to protobuf in the iam binding update (#​1838) (9fb3cb4)

Documentation

• Add data visualization samples for public doc (#​1847) (15e1277)
• Changed broken logo (#​1866) (e3c06b4)
• Update ai.forecast notebook (#​1844) (1863538)

v2.8.0

Compare Source

⚠ BREAKING CHANGES

• add required param 'engine' to multimodal functions (#​1834)

Features

• Add bpd.options.compute.maximum_result_rows option to limit client data download (#​1829) (e22a3f6)
• Add bpd.options.display.repr_mode = "anywidget" to create an interactive display of the results (#​1820) (be0a3cf)
• Add DataFrame.ai.forecast() support (#​1828) (7bc7f36)
• Add describe() method to Series (#​1827) (a4205f8)
• Add required param 'engine' to multimodal functions (#​1834) (37666e4)

Performance Improvements

• Produce simpler sql (#​1836) (cf9c22a)

Documentation

• Add ai.forecast notebook (#​1840) (2430497)

v2.7.0

Compare Source

Features

• Add bbq.json_query_array and warn bbq.json_extract_array deprecated (#​1811) (dc9eb27)
• Add bbq.json_value_array and deprecate bbq.json_extract_string_array (#​1818) (019051e)
• Add groupby cumcount (#​1798) (18f43e8)
• Support custom build service account in remote_function (#​1796) (e586151)

Bug Fixes

• Correct read_csv behaviours with use_cols, names, index_col (#​1804) (855031a)
• Fix single row broadcast with null index (#​1803) (080eb7b)

Documentation

• Document how to use ai.map() for information extraction (#​1808) (b586746)
• Rearrange README.rst to include a short code sample (#​1812) (f6265db)
• Use pandas API instead of pandas-like or pandas-compatible (#​1825) (aa32369)

v2.6.0

Compare Source

Features

• Add blob.transcribe function (#​1773) (86159a7)
• Implement ai.classify() (#​1781) (8af26d0)
• Implement item() for Series and Index (#​1792) (d2154c8)
• Implement ST_ISCLOSED geography function (#​1789) (36bc179)
• Implement ST_LENGTH geography function (#​1791) (c5b7fda)
• Support isin with bigframes.pandas.Index arg (#​1779) (e480d29)

Bug Fixes

• Address read_csv with both index_col and use_cols behavior inconsistency with pandas (#​1785) (ba7c313)
• Allow KMeans model init parameter as k-means++ alias (#​1790) (0b59cf1)
• Replace function now can handle bpd.NA value. (#​1786) (7269512)

Documentation

• Adjust strip method examples to match latest pandas (#​1797) (817b0c0)
• Fix docstrings to improve html rendering of code examples (#​1788) (38d9b73)

v2.5.0

Compare Source

⚠ BREAKING CHANGES

• the updated ai.map() parameter list is not backward-compatible

Features

• Add bpd.options.bigquery.requests_transport_adapters option (#​1755) (bb45db8)
• Add bbq.json_query and warn bbq.json_extract deprecated (#​1756) (ec81dd2)
• Add bpd.options.reset() method (#​1743) (36c359d)
• Add DataFrame.round method (#​1742) (3ea6043)
• Add deferred data uploading (#​1720) (1f6442e)
• Add deprecation warning to Gemini-1.5-X, text-embedding-004, and remove remove legacy models in notebooks and docs (#​1723) (80aad9a)
• Add structured output for ai map, ai filter and ai join (#​1746) (133ac6b)
• Add support for df.loc[list, column(s)] (#​1761) (768a757)
• Include bq schema and query string in dry run results (#​1752) (bb51147)
• Support inplace=True in rename and rename_axis (#​1744) (734cc65)
• Support unique() for Index (#​1750) (27fac78)
• Support astype conversions to and from JSON dtypes (#​1716) (8ef4de1)
• Support dict param for dataframe.agg() (#​1772) (f9c29c8)
• Support dtype parameter in read_csv for bigquery engine (#​1749) (50dca4c)
• Use read api for some peek ops (#​1731) (108f4d2)

Bug Fixes

• Fix clip int series with float bounds (#​1739) (d451aef)
• Fix error with self-merge operations (#​1774) (e5fe143)
• Fix the default value for na_value for numpy conversions (#​1766) (0629cac)
• Include location in Session-based temporary storage manager DDL queries (#​1780) (acba032)
• Prevent creating unnecessary client objects in multithreaded environments (#​1757) (1cf9f5e)
• Reduce bigquery table modification via DML for to_gbq (#​1737) (545cdca)
• Stop ignoring arguments to MatrixFactorization.score(X, y) (#​1726) (55c07e9)
• Support JSON and STRUCT for bbq.sql_scalar (#​1754) (190390b)
• Support str.replace re.compile with flags (#​1736) (f8d2cd2)

Performance Improvements

• Faster local data comparison using idenitity (#​1738) (2858b1e)
• Optimize repr for unordered gbq table (#​1778) (2bc4fbc)
• Use JOB_CREATION_OPTIONAL when allow_large_results=False (#​1763) (15f3f2a)

Dependencies

• Avoid gcsfs==2025.5.0 (#​1762) (68d5e2c)

Documentation

• Add llm output_schema notebook (#​1732) (b2261cc)
• Add MatrixFactorization to the table of contents (#​1725) (611e43b)
• Fix typo for "population" in the GeminiTextGenerator.predict(..., output_schema={...}) sample notebook (#​1748) (bd07e05)
• Integrations notebook extracts token from bqclient._http.credentials instead of bqclient._credentials (#​1784) (6e63eca)
• Updated multimodal notebook instructions (#​1745) (1df8ca6)
• Use partial ordering mode in the quickstart sample (#​1734) (476b7dd)

v2.4.0

Compare Source

Features

• Add "dayofyear" property for dt accessors (#​1692) (9d4a59d)
• Add .dt.days, .dt.seconds, dt.microseconds, and dt.total_seconds() for timedelta series. (#​1713) (2b3a45f)
• Add DatetimeIndex class (#​1719) (c3c830c)
• Add isocalendar() for dt accessor" (#​1717) (0479763)
• Add bigframes.bigquery.json_value (#​1697) (46a9c53)
• Add blob.exif function support (#​1703) (3f79528)
• Add inplace arg support to sort methods (#​1710) (d1ccb52)
• Improve error message in Series.apply for direct udfs (#​1673) (1a658b2)
• Publish bigframes blob(Multimodal) to preview (#​1693) (e4c85ba)
• Support () operator between timedeltas (#​1702) (edaac89)
• Support forecast_limit_lower_bound and forecast_limit_upper_bound in ARIMA_PLUS (and ARIMA_PLUS_XREG) models (#​1305) (b16740e)
• Support to_strip parameter for str.strip, str.lstrip and str.rstrip (#​1705) (a84ee75)

Bug Fixes

• Fix dayofyear doc test (#​1701) (9b777a0)
• Fix issues with chunked arrow data (#​1700) (e3289b7)
• Rename columns with protected names such as _TABLE_SUFFIX in to_gbq() (#​1691) (8ec6079)

Performance Improvements

• Defer query in read_gbq with wildcard tables (#​1661) (5c125c9)
• Rechunk result pages client side (#​1680) (67d8760)

Dependencies

• Move bigtable and pubsub to extras (#​1696) (597d817)

Documentation

• Add snippets for Matrix Factorization tutorials (#​1630) (24b37ae)
• Deprecate bpd.options.bigquery.allow_large_results in favor of bpd.options.compute.allow_large_results (#​1597) (18780b4)
• Include import statement in the bigframes code snippet (#​1699) (08d70b6)
• Include the clean-up step in the udf code snippet (#​1698) (48992e2)
• Move multimodal notebook out of experimental folder (#​1712) (68b6532)
• Update blob_display option in snippets (#​1714) (8b30143)

v2.3.0

Compare Source

Features

• Add dry_run parameter to read_gbq(), read_gbq_table() and read_gbq_query() (#​1674) (4c5dee5)

Bug Fixes

• Guarantee guid thread safety across threads (#​1684) (cb0267d)
• Support large lists of lists in bpd.Series() constructor (#​1662) (0f4024c)
• Use value equality to check types for unix epoch functions and timestamp diff (#​1690) (81e8fb8)

Performance Improvements

• to_datetime() now avoids caching inputs unless data is inspected to infer format (#​1667) ([dd08857](https://redirec